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PROGRAM-INTERFACE CONVERTER 
FOR MULTIPLE-PLATFORM COMPUTERS 

5 

Field of the Invention 
The present invention relates to electronic data processing, and more 
specifically concerns a software tool for generating a set of translation-code 
modules for translating application-program interfaces (APIs) from one platform 
10 to another, for use with an emulator which allows application programs written 

for one platform to be executed on a different platform. 

Background of the Invention 
Present-day application programs almost never interface directly to the 
hardware of the computer system in which they execute. Instead, application 
15 program interfaces (APIs) call code modules which control the hardware, or 

which call programmed interfaces at yet lower levels. Most API code modules 
reside in an operating system (OS), although others may exist in a basic 
input/output system (BIOS), or in other places. Code modules for API functions 
typically reside in freestanding dynamic link library (DLL) files each containing 
20 routines for carrying out dozens or even hundreds of API functions. 

Executing an application program written for one computer processor, 
operating system, or other platform on another platform requires a program, 
variously known as an emulator, simulator, interpreter, or translator, to convert 
instructions, data formats, application-program interfaces (APIs), and other 
25 characteristics of the application from the those of its original platform to those 

of the native platform in which the emulator runs. Sometimes the original 
platform has been replaced, but the old application must still be run on the new 
platform. Sometimes programs are written to an abstract platform, so that the 
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same application can be executed on numerous different platforms merely by 
writing an emulator for each native platform that is to host the abstract platform. 

An emulator subsystem generally has two major components. The 
emulator itself converts the original processor instructions from the application 
5 into instructions or groups of instructions appropriate to the processor of the new 

platform, and executes them. An API translation layer "thunks" API calls from 
the original platform being emulated into calls to APIs written for the native 
platform; that is, it intercepts API calls made by an application written for the 
emulated platform, converts their arguments from the calling convention of the 
10 original platform to that of the native platform, then calls an appropriate native- 

platform module for executing the API function. A translation module or "API 
thunk" is a piece of program code in the translation layer which executes 
between a particular original API and the operating system running on the native 
platform. 

15 Conventional practice involves hand-writing thunk code for each new 

and modified API. However, an API set may change daily during the 
development of an operating system. Also, the number of APIs can be very 
large. The Microsoft Windows NT operating system, for example, contains 
more than 3,500 APIs in 42 different DLL modules. Therefore, manual 

20 production of individual API translation code becomes increasingly impractical. 

Increasingly shorter product cycles compounds this problem. 

Some interface modules or thunks have been generated from hand- 
written descriptors for each separate API. However these must be maintained 
separately from the APIs themselves, and thus involve costly additional effort. 

25 They also suffer from "synchronization" problems: if one or more modules 

inadvertently escape an update between one development iteration and the next, 
their dovm-level code may mistranslate an API, or may crash the system. Such 
problems can be difficult to find, thus forcing the entire development effort to 
wait. 
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Alternatively, a software tool has been employed to create a set of 
skeleton API thunks as C-language source files which were then hand-modified. 
This approach is impractical, in that renmning the tool destroys all the hand 
edits. 

5 Summary of the Invention 

A utility program according to the present invention creates and 
automatically updates code modules for translating APIs written for one platform 
so that they will execute properly on a different platform. The utility, executed 
for every new development iteration of an operating system or other software 

10 environment, uses a set of templates for constructing source code for the 

translation modules, based upon the functions performed by the APIs. Special 
translation requirements are handled by exception templates containing 
personalized translation code. Another kind of template performs type 
conversions from the original APIs' parameters or arguments into those of the 

1 5 different platform. 

Automatic code generation in this manner enables much faster 
development iterations by providing an automated method of synchronizing the 
translation modules with changes made to the new operating system or 
environment. The code generator ensures that all translation modules are at the 

20 current updated level, which prevents system crashes caused by incompatible 

modules. It also greatly reduces errors within individual code modules resulting 
from prior hand generation methods, and eliminates errors across modules 
caused from different people working independently on different modules. 

Other features and advantages, as well as modifications and additions 

25 within the scope of the invention, will appear to those skilled in the art from the 

following description. 

Description of the Drawings 
FIG. 1 is a block diagram of a computer system in which the invention 
may be practiced. 
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FIG. 2 is a high-level block diagram of a multiple-platform emulation 
enviromnent in which the invention finds utility. 

FIG, 3 is a high-level block diagram of a translator utility according to 
the invention, along with its inputs and outputs. 
5 FIG. 4 is a flow diagram showing the operation of the translator of 

Fig. 3. 

Detailed Description 
FIG. 1 provides a brief, general description of a suitable computing 
environment in which the invention may be implemented. Hardware and 

10 software environments will first be discussed, followed by a detailed description 

of the invention comprising a tool for creating and automatically updating code 
modules for translating APIs written for one platform so that they will execute 
properly on a different platform. The invention will hereinafter be described in 
the general context of computer-executable instructions such £is program 

15 modules, executed by a personal computer (PC); however, other environments 

are possible. Program modules include routines, programs, objects, components, 
data structures, etc. that perform particular tasks or implement particular abstract 
data types. Those skilled in the art will appreciate that the invention may be 
practiced with other computer-system configurations, including hand-held 

20 devices, multiprocessor systems, microprocessor-based programmable consumer 

electronics, network PCs, minicomputers, mainframe computers, and the like. 
The invention may also be practiced in distributed computing environments 
where tasks are performed by remote processing devices linked through a 
conmnmications network. In a distributed computing environment, program 

25 modules may be located in both local and remote memory storage devices. 

FIG. 1 shows an exemplary system for implementing the invention. It 
employs a general-purpose computing device in the form of a conventional 
personal computer 20, which includes processing unit 21, system memory 22, 
and system bus 23 that couples the system memory and other system 
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components to processing unit 21 . System bus 23 may be any of several types, 
including a memory bus or memory controller, a peripheral bus, and a local bus, 
and may use any of a variety of bus structures. System memory 22 includes 
read-only memory (ROM) 24 and random-access memory (RAM) 25. A basic 
5 input/output system (BIOS) 26, stored in ROM 24, contains the basic routines 

that transfer information between components of personal computer 20. BIOS 
24 also contains start-up routines for the system. Personal computer 20 further 
includes hard disk drive 27 for reading from and writing to a hard disk (not 
shown), magnetic disk drive 28 for reading from and writing to a removable 

10 magnetic disk 29, and optical disk drive 30 for reading from and writing to a 

removable optical disk 3 1 such as a CD-ROM or other optical medium. Hard 
disk drive 27, magnetic disk drive 28, and optical disk drive 30 are connected to 
system bus 23 by a hard-disk drive interface 32, a magnetic-disk drive interface 
33, and an optical-drive interface 34, respectively. The drives and their 

1 5 associated computer-readable media provide nonvolatile storage of computer- 

readable instructions, data structures, program modules and other data for 
personal computer 20. Although the exemplary environment described herein 
employs a hard disk, a removable magnetic disk 29 and a removable optical disk 
31, those skilled in the art will appreciate that other types of computer-readable 

20 media which can store data accessible by a computer may also be used in the 

exemplary operating environment. Such media may include magnetic cassettes, 
flash-memory cards, digital versatile disks, BemouUi cartridges, RAMs, ROMs, 
and the like. 

Program modules may be stored on the hard disk, magnetic disk 29, 
25 optical disk 31, ROM 24 and RAM 25. Program modules may include operating 

system 35, one or more application programs 36, other program modules 37, and 
program data 38. A user may enter commands and information into personal 
computer 20 through input devices such as a keyboard 40 and a pointing device 
42. Other input devices (not shown) may include a microphone, joystick, game 
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pad, satellite dish, scanner, or the like. These and other input devices are often 
connected to the processing unit 21 through a serial-port interface 46 coupled to 
system bus 23; but they may be connected through other interfaces not shown in 
Figure 1, such as a parallel port, a game port, or a universal serial bus (USB). A 
5 monitor 47 or other display device also connects to system bus 23 via an 

interface such as a video adapter 48. In addition to the monitor, personal 
computers typically include other peripheral output devices (not shown) such as 
speakers and printers. 

Personal computer 20 may operate in a networked environment using 

10 logical connections to one or more remote computers such as remote computer 

49. Remote computer 49 may be another personal computer, a server, a router, a 
network PC, a peer device, or other common network node. It typically includes 
many or all of the components described above in connection with personal 
computer 20; however, only a storage device 50 is illustrated in Figure 1. The 

15 logical connections depicted in Figure 1 include local-area network (LAN) 5 1 

and a wide-area network (WAN) 52. Such networking envirormients are 
commonplace in offices, enterprise-wide computer networks, intranets and the 
Intemet. 

When placed in a LAN networking environment, PC 20 connects to local 
20 network 51 through a network interface or adapter 53. When used in a WAN 

networking environment such as the Intemet, PC 20 typically includes modem 
54 or other means for establishing commimications over network 52. Modem 54 
may be internal or external to PC 20, and connects to system bus 23 via serial- 
port interface 46. In a networked environment, program modules depicted as 
25 residing within 20 or portions thereof may be stored in remote storage device 50. 

Of course, the network coimections shown are illustrative, and other means of 
establishing a communications link between the computers may be substituted. 

FIG. 2 shows a software environment 200 for running an application 
program 210 for one platform on a processor 220 representing a different 
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platform. The elements enclosed in dashed line 201 are elements designed to be 
executed on a first platform such as a processor 21, Fig. 1, of the Intel "X86" 
family— for example an Intel 80386, 80486, or Pentium microprocessor. The 
other elements execute on a second platform, such as a Digital Equipment Corp. 
5 "Alpha" or an IBM "PowerPC" microprocessor serving as processor 21 . This 

description refers to the first and second platforms as the "X86" and "native" 
platforms, respectively. For purposes of illustration, a native-platform version 
230 of the Microsoft NT operating system serves as OS 35, FIG. 1. 

Conventional emulator program 240 translates the instructions, data, and 
10 interfaces (APIs) of an X86-platform application program such as 36, FIGs. 1 

and 2, from those of the X86 platforms to equivalent operations in the native 
platform. The APIs of an application program are actually calls to a set 250 of 
API modules 251-253, only a very few^ of which are shown in FIG. 2. API 
modules are commonly grouped into dynamic link libraries such as 254. As 
15 noted previously, OS 230 has thousands of APIs in more than forty DLLs; this 

set, collectively known as "Win32," is recompiled into a new "build" almost 
daily during a development effort. When application 210 calls an API written 
for the X86 platform, such as API 251, a conventional API translation layer 241 
in emulator 240 retrieves the proper API module 251, and calls an associated 
20 translation-code module, or "thunk," 261 to convert any API arguments and data 

to the correct format for the native platform, and to perform functions which 
emulate those the API would have performed on the original X86 platform. The 
set of thxmks 260 includes a separate module 261-262 for each X86 API 251- 
252. APIs such as 253 written for the native platform execute directly when 
25 called from OS 230, and do not require thunks. 

FIG. 3 is a high-level block diagram 300 showing a translator utility 
according to the invention, along with its inputs and outputs. Some of the 
elements shown in FIG. 2 have different labels in FIG. 3, to denote that the 
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corresponding elements are in compiled object-code form in FIG. 2, but exist as 
source-code files in FIG. 3. 

In its source-code form, each DLL 254, FIG. 2, is a collection 3 1 0 of files 
311 each containing instructions in a language such as C for an API 250, FIG. 2. 
5 Each file represents one or more functions 3 1 2 to be performed by one of the 

APIs 251-252. [@@ Inventor note 1] (Some terminology: a dynamic link 
library is generated from three source files, viz a C source-code file, a C header 
file, and a .DEF file. The compiler converts these into two object files, a .DLL 
code file and an import .LIB file.) 

10 A module-definition file (.DEF) file 322 specifies the list of functions 

which are to be exported from DLL 320 as APIs. The .DEF file compiled into 
an import library (.LIB) file 321 . The .LIB file is significant because the API 
name exported from the DLL may differ from the function name in source file 
3 1 1 ; for example, an entry foo=bar@4 in a .DEF file instmcts the linker to 

1 5 export the function known intemally as FOO from the DLL as bar. Thimk 

generator 330 uses .LIB file 321 to associate an internal function name with an 
exported API name. C-language files have associated header (.H) files 313 that 
specify the extemal interface of their code file 311, such as data types and 
extemal variable names. In particular, header files include type information 315 

20 for functions 3 12 in code files 311. 

For example, a .H header file could contain a type definition such as: 

Typedef struct tagFoo { 
int member 1; 
int member2; 
25 } *PFOO 

and a function declaration: 

int AnApi {PFOO argl, char *}/ 
Generator 330 stores this information for all APIs. The entries for the above 
example might be: 
30 TYPENAME struct tagFoo 
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10 



MEMBER LIST 

MEMBER NAME member 1 
MEMBER TYPE int 
MEMBER OFFSET 0 
MEMBER NAME member 2 
MEMBER TYPE int 



MEMBER 


OFFSET 4 


TYPENAME PFOO 






INDIRECTION 


1 




BASETYPE struct tagFoo 


APINAME AnApi 






RETURN TYPE 




int 


ARC NAME 




argl 


ARG TYPE 




PFOO 


ARC NAME 




<noname> 


ARG TYPE 




char * 



15 



Finally, a conventional definitions (.DEF) file 322 may instruct a 
conventional linker (not shown) in OS 230 to export an internal API name firom 
DLL 320 as a different name. 

20 Translation generator 330 uses information firom files 311,313, and 321 

to build C-language source-code files 340 which can be compiled into the 
translation-code modules 260 in FIG. 2. The invention provides a novel set of 
template files 350 for this purpose. Template (.TPL) files are descriptions of 
how to generate translation-code modules ("thunks"). They comprise small 

25 amovmts of hand-generated C code which implement generalized forms for 

iterating over API fimctions and their arguments, and for handling special cases 
which may arise in particular APIs. Each template has the following syntax: 

[ Type_of_Template] 

T emp 1 a t e N ame = Nam e_ Oi[_ Teinp i a t e 

CgenBegin= 

<code to generate when this template is expanded> 
CgenEnd= 
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There are four types of template 350. 

The iterated-function (IFunc) template 351 iterates over API functions. 
Generator 330 expands one of these for each exported function in an APL The 
IFunc template 351 is the default expansion for APIs. The following example 
5 template will generate a skeleton thunk 340. 

[Ifunc] 

TemplateName=HostFuncs 

CgenBegin= 

Void 

wh@ApiName (PULONG BaseArgs, ULONG RetVal) 
{ 

QApiFnRet *pRetVal - (@ApiFnRet *) RetVal; 
©Types (Locals) 

@Types (Body) 

eifApiRet (*pRetVal = ) @ApiName {(aifArgs (QArgList 
( * ( ( @ArgType 

* ) ( @ArgAddr (BaseArgs ) ) ) @ArgMore (,)))); 
@Types (Return) 

} 

CgenEnd= 

Generator 330 expands each of the '@'-prefixed keywords in template 351 from 
the data collected from files 313 and 321 for a particular API 310 as follows: 



@ApiName 


Internal name of the API 


(gApiFnRet 


Retum type of the API 


@Types(x) 


Expands Type templates of the form 'x' 


@IfApiRet(x) 


Expands 'x' if the retum type of the API is non-void 


@IfArgs(x) 


Expands 'x' if the API has arguments 


@ArgList(x) 


Iterates over all arguments, expanding 'x' for each argument 


@ArgType 


Type of argument 
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@AxgAddr(x) Address of the argument, relative to *x' 

@ArgMore(x) Expands if there are more arguments after the current one 

For example, an API with prototype 'HWND FindWindowA(LPSTR IpClass, 
LPSTR Ip Window)' expands to: 

WhFindWindowA (PULONG pBaseArgs, ULONG RetVal) 
{ 

HWND ^pRetVal = (HWND *) RetVal; 

*pRetVal == FindWindowA( * (LPSTR *) (pBaseArgs+0 ) , * 
(LPSTR *) (pBaseArgs+1) ); 
} 

An exception-function (EFunc) template 352 recognizes a particular API 
name, and overrides the default IFunc template 351 for that API. The 
following example template 352 produces fixed code for the particular API 
named 'SetErrorMode'. [Efunc] 

TemplateName=SetErrorMode 

CgenBegin= 

Void 

Wh@ApiName (PULONG BaseArgs, ULONG RetVal) 
{ 

©ApiFnRet *pRetVal = (@ApiFnRet *) RetVal; 
*pRetVal = SetErrorMode ( (* (UINT *) pBaseArgs) | 
SEM_NOALIGNMENTFAULTEXCEPT ) 

*pRetVal &= -SEM__NOALIGNMENTFAULTEXCEPT; 

} 

CgenEnd= 

EFunc templates provides a facility for custom-writing code for an API, while 
5 preserving robustness against API changes. Of course, the code for such an API 

can always be rewritten merely by rewriting its EFxmc template. 

A types (Types) template 353 creates a thimk 340 for each parameter, or 
argument, of each API file 311 which matches a specified type name. Types 
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templates are powerful in that generator 330 applies them automatically to new 
APIs, providing correct thunking without manual intervention. Consider the 
following examples: 

[Types] 

Tempi at eName=Locals 
TypeNaitie=LPSTR 
IndLevel==0 
CgenBegin= 

QArgLocal == * ( (QArgType *) (pBaseArgs + @ArgOf f ) ) ; 
CgenEnd= 

[Types] 

TemplateNaine=Body 
TypeNaine=LPSTR 
IndLevel=0 
CgenBegin== 

VALIDATE_LPSTR ( @ArgNaineLocal ) ; 
CgenEnd= 

5 With these two templates, any API 311 which takes the C-language 

LPSTR data type automatically receives the special-purpose Types code in 
addition to the IFunc code for the default IFunc template. For example, the 
'FindWindowA' API described above now expands to: 

{ 

HWND *pRetVal - (HWND *) RetVal; 

LPSTR IpClass = (LPSTR *) (pBaseArgs + 0); 

LPSTR IpWindow = *( (LPSTR *) (pBaseArgs + 1) ; 

VALIDATE_LPSTR (IpClass) ; 
VALIDATE_LPSTR (IpWindow) ; 

*pRetVal = FindWindowA ( IpClass, IpWindow ) ; 

} 
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A code template 354 operates like a macro. It contains code which may 
be common to a number of other templates, and is referred to by name in those 
templates. For example, if the line 

*pRetVal = SetErrorMode ((*(UINT *) pBaseArgs) | 

occurs many times in many different templates 351, 352, or 353, then that line 
5 could be placed in a code template such as one named, "serrm." The referring 

templates, such as the example above, then merely replace that line with the 
name of the macro, for example "[@serrm]". The conventional C macro facility 
then replaces the name with the code; C macros can, of course, be much more 
complex than this simple example. 

10 Although the above templates are shown as written in the C language, 

they are language-independent. Templates 350 may generate code in C++, in 
assembler language, or in any other desired form. 

FIG. 4 describes the steps 400 carried out by translation-code generator 
330, FIG. 3. The generator is run at 401 for every build of the operating system 

15 230 or other entity whose APIs require regeneration. At its conclusion 402, the 

entire set of API translation-module source-code files 340 has been synchronized 
at the same level, and can be compiled in a conventional manner into the set of 
object-code modules 260, FIG. 2 which together form an API-translation portion 
(the "thunk layer") of emulator 240. 

20 Block 410 scans all the DLLs 254 belonging to the OS 230 to identify the 

set of APIs (261, 262,... in FIG. 2) which require regeneration. The names of 
these APIs are in the export table 314 and in the import .LIB file 321 of each 
DLL, as previously described. (As a technical aside, the raw exports come from 
the import .LIB. However, many of them may be unnamed ordinals or renamed 

25 C functions. In order to obtain type information, generator 330 must reconstruct 

the name of the original function that implements each API. Thus, it must 
sometimes unmap the export name back to the function name.) Step 403 then 
sequentially selects a current API in the set for processing. 
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Step 420 may identify the current API as having an exception template 
352, by a conventional table-lookup in a list of the exception-template names. If 
such a template exists, step 421 accesses the associated EFunc template, and step 
422 places its source code into a thunk file 340 for that API. 
5 If the current API is a normal API, step 430 reads export table 3 14 of its 

header file 313 to extract the names of all its exported functions. Step expands 
the IFunc template 351 for those functions, as described above. When step 431 
has iterated through all the exported functions of the current API, exit 432 
progresses to the next step. 

10 Step 440 cycles through the parameters (arguments) of the current API, 

sequentially selecting one as a current parameter. If step 441 determines that a 
Types template 353 exists for this parameter type, then step 442 places the 
template's source code in the module 340, so that the API will process that 
argument type correctly. Most types templates substitute a different value for a 

1 5 parameter. However, a types template may perform other functions, such as 

validating the range of a parameter. Control passes to exit 443 when all Types 
templates have been processed. 

Step 450 processes Code templates 354, FIG. 3. Whenever the name of a 
code template appears (as a macro name) in template-processing step 422, 432, 

20 or 442, dashed lines 451 call step 450 to expand a particular named code 

template and retum the code to the calling template. Step 450 may actually 
occur later, when the thunk source-code files 340 are conventionally compiled 
into object-code modules 260. 

It is to be vmderstood that the above description is intended to be 

25 illustrative, and not restrictive. The invention may be used to provide for 

execution of interfaces from multiple prior platforms as opposed to just one. 
Further, template matching can be done in many different manners, such as by 
having a field in an interface which directly identifies a desired template. Many 
other embodiments will be apparent to those skilled in the art upon reviewing the 



wo 99/09474 



15 



PCTAJS98/17008 



above description. The scope of the invention should, therefore, be determined 
with reference to the appended claims, along with the full scope of equivalents to 
which such claims are entitled. 
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What is claimed is: 



1 . In a programmable digital computer, a method for generating a 

synchronized set of translation modules containing program code for executing 
5 on a native platform a corresponding set of interface modules written for an 

emulated platform, the method comprising: 

identifying the set of interface modules written for the emulated 
platform and requiring translation for the second platform; 

for all interface modules in the set, sequentially selecting a source- 
10 code file representing one of the set of interface modules as a current module; 

extracting from the current module data representing a group of 
functions exported by the current module; 

matching the current-module data to a group of function templates, at 
least some of the templates containing generalized program code written for the 
1 5 native platform and performing functions from the emulated platform; 

selecting at least one of the templates in response to the matching step; 

and 

for each template selected, converting the generalized program source 
code in the template into personalized program code constituting at least part of 
20 the translation module for the current module. 



2. A method according to claim 1 , further comprising: 

determining that the current module matches one of a group of 
exception templates each containing program code; and 
25 generating at least part of the translation module for the current 

module from the program code of the one exception template. 



3. 



A method according to claim 2, further comprising: 
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10 



bypassing matching the current-module data against the function 
templates when the current module matches one of the group of exception 
templates. 

4. A method according to claim 1 wherein the current module has at least 

one parameter having one of a group of types, further comprising 

matching the one parameter to one of a group of types templates; and 
generating at least some of the program code of the current translation 
module from the one types template. 



5. A method according to claim 1, further comprising: 
determining that one of the templates specifies the name of one of a 

group of a code templates; and 

incorporating source code from the specified code template in the one 
1 5 template whenever the one template provides code for a translation module. 

6. A method according to claim 1 wherein the interface modules have an 
import table and reside in at least one link library, and wherein the identifying 
step comprises: 

20 scanning the link library; and 

reading the names of the interface modules in the set from the import 

tables. 

7. A method according to claim 1, further comprising: 

25 iterating the matching, selecting and converting steps over each of the 

functions in the group of functions. 



8. A computer system for producing a set of synchronized translation 

modules each containing code for translating a different interface written for a 
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first platform into instructions for executing that interface on a second platform, 
the system comprising: 

a set of interface files each comprising source code for implementing 
one of the interfaces; 

a set of header files associated with respective ones of the interface 
files and containing the names of functions exported by the respective interface 
files; 

an import library containing names of the interface files in the set; 

a group of function template files containing generalized source code 
for executing a group of translation functions; and 

a generator for matching certain of the interface modules to at least 
one of the function templates and for converting the generalized code of the one 
function template into personalized source code for executing at least one of 
those functions exported by the interface modules, the personalized code forming 
at least a portion of the translation modules. 

9. A computer system according to claim 8, fiirther comprising a group 
of exception template files associated with certain ones of the translation 
modules, and wherein the generator produces source code forming at least part of 
the code of the translation modules from one of the exception templates instead 
of from the function templates. 

10. A computer system according to claim 8, further comprising a group 
of types templates respectively containing source code for a group of data types 
found in certain of the interface modules, and wherein the generator incorporates 
forming a part of the translation modules from those of the types templates 
corresponding to the data types found in the certain interface modules. 
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11. A digital computer system for executing an application program 
written for an emulated platform on a native platform, comprising: 

an operating system executing on the native platform; 

a set of interface modules executable on the emulated platform; 

an emulator for executing on the native platform an application 
program written for an emulated platform and having a set of interfaces 
executable on the emulated platform; 

a group of function templates each containing generalized code for 
executing a function; 

a group of types templates each containing conversion code for 
converting a data type of the emulated platform to a data type of the native 
platform; and 

a set of translation modules for executing respective ones of the 
interface modules on the native platforms, the translation modules containing 
person£Llized code firom the function templates and conversion code from the 
types templates. 

12. A digital computer system according to claim 11, further comprising a 
group of exception templates containing code associated with particular 
respective ones of the interface modules, wherein at least some of the translation 
modules conteiin code directly contained in the exception modules. 

13. A computer-readable medium having computer-executable 
instructions for generating a synchronized set of translation modules containing 
program code for executing on a native platform a corresponding set of interface 
modules written for an emulated platform by performing the steps of: 

identifying the set of interface modules written for the emulated 
platform and requiring translation for the native platform; 
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for all interface modules in the set, sequentially selecting a source- 
code file representing one of the set of interface modules as a current module; 

extracting from the current module data representing a group of 
functions exported by the current module; 
5 matching the current-module data to a group of function templates, at 

least some of the templates containing generalized program code written for the 
native platform and performing functions from the emulated platform; 

selecting at least one of the templates in response to the matching step; 

and 

10 for each template selected, converting the generalized program source 

code in the template into personalized program code constituting at least part of 
the translation module for the current module. 



14. A medium according to claim 13, including further instructions for: 

15 determining that the current module matches one of a group of 

exception templates each containing program code; and 

generating at least part of the translation module for the current 
module from the program code of the one exception template. 

20 15. A medium according to claim 1 3 wherein the current module has at 

least one parameter having one of a group of types, the medium including further 
instructions for: 

matching the one parameter to one of a group of types templates; and 
generating at least some of the program code of the current translation 
25 module from the one types template. 



16. A method for automatically generating translation code for executing 

interfaces written for a first platform on a second, different platform, comprising: 
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constructing a generalized template capable of performing a plurality 
of different functions; 

extracting a plurality of functions performed by the interfaces written 
for the first platform; and 

personalizing the generalized template to produce translation code for 
each of the functions performed by the interfaces. 

17. A method according to claim 16, further comprising: 
constructing a plurality of additional templates each associated with a 

particular type of parameter in the interfaces; and 

generating translation code from one of the additional templates for the 
parameters associated with any of the additional templates. 

18. A method for automatically generating translation code for executing 
an interface written for a first platform on a second, different platform, 
comprising: 

selecting one of a plurality of generalized templates based on 
information contained in an interface written for the first platform; and 

personalizing the generalized template to produce translation code for 
the interface to execute on the second platform, 

19. The method of claim 18 and further comprising the step of repeating 
the selecting and personalizing steps for each interface written for the first 
platform until all interfaces in a program are translated. 

20. The method of claim 18, wherein the information comprises functions 
performed by the interface. 
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21 . A computer-readable medium having computer-executable 

instructions for generating a synchronized set of translation modules for 
executing an interface written for a first platform on a second, different platform, 
by causing a suitably configured computer system to perform the steps of: 
5 selecting one of a plur£dity of generalized templates based on 

information contained in an interface written for the first platform; and 

personalizing the generalized template to produce translation code for 
the interface to execute on the second platform. 
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